Inside Macintosh: QuickTime /

Chapter 3 - Image Compression Manager / Image Compression Manager Reference

Image Compression Manager Functions / Working With Images

SetImageDescriptionCTable

Your application may use the SetImageDescriptionCTable function to update the custom color table for an image. The Image Compression Manager copies the custom color table for an image into the appropriate image description structure. This function does not change the image data, just the color table.

pascal OSErr SetImageDescriptionCTable 
                           (ImageDescriptionHandle desc,
                              CTabHandle ctable);

desc

Contains a handle to the appropriate image description structure. The SetImageDescriptionCTable function updates the size of the image description to accommodate the new color table and removes the old color table, if one is present.

ctable

Contains a handle to the new color table. The SetImageDescriptionCTable function loads this color table into the image description referred to by the desc parameter. Set this parameter to nil to remove a color table.

DESCRIPTION

The SetImageDescriptionCTable function is rarely used. Typically, you supply the color table when your application compresses an image. The Image Compression Manager stores the color table with the image.

RESULT CODES

noErr	0	No error
paramErr	-50	Invalid parameter specified
memFullErr	-108	Not enough memory available
noCodecErr	-8961	The Image Compression Manager could not find the specified compressor